home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / async.zip / ASYNC.DOC < prev    next >
Encoding:
Text File  |  1986-10-10  |  7.1 KB  |  264 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.           ASYNC (1)          ASYNC BIOS REPLACEMENT          ASYNC (1)
  69.  
  70.  
  71.  
  72.      NAME    
  73.      NAME  
  74.  
  75.  
  76.           ASYNC.COM 
  77.  
  78.  
  79.      SYNOPSIS    
  80.      SYNOPSIS  
  81.  
  82.  
  83.           async com         
  84.           async.com [0|1] 
  85.  
  86.  
  87.      DESCRIPTION    
  88.      DESCRIPTION  
  89.  
  90.  
  91.           async com                                                     
  92.           async.com  is  a  terminate-and-stay  resident  program that
  93.           replaces the  IBM-PC  ROM-BIOS  asynchronous  communications
  94.           services  with  a servicable interrupt-driven communications
  95.           driver.  
  96.  
  97.  
  98.                              async 0    async 1                         
  99.           To invoke it, type async 0 or async 1 and it takes over  the
  100.           communications port.  Since PC-DOS uses the rom bios INT 14H 
  101.                                       COM1  COM2     AUX                
  102.           service  for all I/O on the COM1, COM2 and AUX devices, this
  103.           program becomes the driver for those devices.  
  104.  
  105.  
  106.                async com                                                 
  107.           Once async.com becomes resident, all input and output to the 
  108.           com-port devices is run through an interrupt driven hardware 
  109.           driver, that is buffered both on input and output.  
  110.  
  111.  
  112.           This is especially useful in  conjunction  with  the  PC-DOS
  113.           CTTY                                                          
  114.           CTTY command,  which  redirects  the  console  device.   The
  115.           standard ROM-BIOS driver is polled, and has  a  tendency  to
  116.           lose characters at high input and output rates.  
  117.  
  118.  
  119.      CAVEATS    
  120.      CAVEATS  
  121.  
  122.  
  123.                       async com                     CTTY                
  124.           If  you use async.com in conjunction with CTTY, keep in mind
  125.           that the CON device is still the PC system  console.    This
  126.                                          COPY CON FILE DAT              
  127.           means  that if you try to do a COPY CON FILE.DAT, the system
  128.           is hung until  someone  at  the  physical  console  types  a
  129.           control-Z.  
  130.  
  131.  
  132.           BASICA                                                        
  133.           BASICA   is,  of  course,  a  no-no,  as  it  does  its  own
  134.           communications device handling.  
  135.  
  136.  
  137.                                                     async com           
  138.           If you want to use both async ports with  async.com,  invoke
  139.           it  twice,  once  for  port  0  (com1)  and  once for port 1
  140.           (com2).  I am not sure what happens if you stack  more  than
  141.                       async com                                          
  142.           one copy of async.com for a given port, except that I/O will 
  143.           probably  slow  down,  and  more  memory  will  be  used up.
  144.           async com                                                     
  145.           async.com doesn't check to make sure that it hasn't  already
  146.           been invoked.  
  147.  
  148.  
  149.           The best way to use async.com for going 'outside' from a BBS 
  150.           is  to  use  the  PD utilities MARK and RELEASE, included in
  151.           this package.   Also  included  is  the  TSR.DOC  file  that
  152.                                        MARK                 async com    
  153.           describes their use.  If you MARK before invoking async.com, 
  154.                      RELEASE                                            
  155.           and  then  RELEASE when you're ready to go back to work, you
  156.                       async com                                         
  157.           don't leave async.com dangling in memory.    An  example  is
  158.           included below.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.                                       -1-
  166.  
  167.  
  168.  
  169.           ASYNC (1)          ASYNC BIOS REPLACEMENT          ASYNC (1)
  170.  
  171.  
  172.  
  173.      EXAMPLES    
  174.      EXAMPLES  
  175.  
  176.  
  177.           The  following is a batch file for invoking a dos shell from
  178.           a BBS.  You may note that a copy of each command  is  echoed
  179.                  CON                                    CTTY COM1     
  180.           to the CON device, which is not redirected by CTTY COM1.  
  181.  
  182.  
  183.                ECHO OFF
  184.                ECHO FMARK \TMP\ASYNC >CON
  185.                FMARK \TMP\ASYNC
  186.                ASYNC 0
  187.                ECHO MODE COM1:96,n,8,1 >CON
  188.                MODE COM1:96,n,8,1
  189.                ECHO CTTY COM1 >CON
  190.                CTTY COM1
  191.                ECHO PC-SHELL >CON
  192.                COMMAND
  193.                ECHO CTTY CON >CON
  194.                CTTY CON
  195.                ECHO RELEASE \TMP\ASYNC >CON
  196.                RELEASE \TMP\ASYNC
  197.  
  198.  
  199.                   async com                                             
  200.           To  use async.com with this batch file (assuming it's called
  201.           outside.bat) : 
  202.  
  203.  
  204.                ASYNC 0 OUTSIDE
  205.  
  206.  
  207.  
  208.      FILES    
  209.      FILES  
  210.  
  211.  
  212.           Filename        Length   Method     Size   Ratio    Date      Time
  213.           --------        ------   ------    ------  -----    ----      ----
  214.           ASYNC.C            954  Crunched      661   31%   10-10-86  14:00:10
  215.           ASYNC.COM         4106  Crunched     3105   25%   10-10-86  14:05:26
  216.           ASYNC.DOC         4422  Crunched     1800   60%   10-10-86  14:33:44
  217.           FMARK.COM          640  Crunched      407   37%   07-20-86  13:33:40
  218.           FORKP.C           2477  Crunched     1419   43%   09-25-86  09:19:10
  219.           HANDLER.ASM       3583  Crunched     1831   49%   10-10-86  09:55:54
  220.           INTCOMM.C         3335  Crunched     1746   48%   10-10-86  08:37:16
  221.           MAKEFILE           246  Crunched      184   26%   10-10-86  14:33:24
  222.           MARK.COM          1408   Packed       174   88%   07-20-86  13:33:02
  223.           MINT.C            3001  Crunched     1589   48%   10-10-86  13:09:06
  224.           RELEASE.COM      16647  Squeezed    15914    5%   07-20-86  13:32:36
  225.           STKSIZ.C          1011  Crunched      697   32%   10-09-86  13:41:32
  226.           TEST.BAT           247  Crunched      162   35%   10-10-86  14:19:12
  227.           TSR.DOC          14675  Crunched     7166   52%   09-07-86  13:01:30
  228.           _CROOT.C          2068  Crunched     1269   39%   09-24-86  16:00:30
  229.  
  230.  
  231.      NOTES    
  232.      NOTES  
  233.  
  234.  
  235.           async com                                                     
  236.           async.com was prepared using AZTEC C86. Debugging  was  done
  237.           with ATRON's software probe software.  
  238.  
  239.  
  240.           This program was written by: 
  241.  
  242.  
  243.                Kent  Williams  722  Rundell  Iowa City, IA 52240 (319)
  244.                338-6053 
  245.  
  246.  
  247.                The mark and  release  utilities  were  extracted  from
  248.  
  249.  
  250.  
  251.                                       -2-
  252.  
  253.  
  254.  
  255.           ASYNC (1)          ASYNC BIOS REPLACEMENT          ASYNC (1)
  256.  
  257.  
  258.  
  259.                TSRCOM.ARC  -  which  is  floating around in FIDO-land.
  260.                They  are  included  here   as   a   service,   without
  261.                permission.  
  262.  
  263.  
  264.           RETURN VALUE    
  265.           RETURN VALUE  
  266.  
  267.  
  268.                None 
  269.                
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                                       -3-
  324.  
  325.  
  326.